home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / bbs / log100s.zip / LOGIT.DOC < prev    next >
Text File  |  1996-01-14  |  13KB  |  342 lines

  1. LOGIT v1.00 Standard
  2.  
  3. By Timothy Steffes
  4. ════════════════════────────────────────────────────────────────────────────
  5.  
  6.  
  7. Warranty:
  8. ═════════───────────────────────────────────────────────────────────────────
  9. None. Zip. Zilch. Zero. If it breaks in two, you own both halves.
  10.  
  11.  
  12. What is LOGIT?
  13. ══════════════──────────────────────────────────────────────────────────────
  14. LOGIT creates a file that lists recent calls to your BBS. It will read
  15. caller information from the command line, DOOR.SYS, your Front Door
  16. LASTCALL.FD file, or Intermail's LASTCALL.IM file. You can also use a
  17. comment function and put whatever you want in the output file.
  18.  
  19. Logit will also create an ASCII text file with your mailer's activity for
  20. the current and previous day compiled for display, or just your curiosity.
  21. I use mine as my BANNER.TXT file for Front Door.
  22.  
  23.  
  24. How Do I Use it?
  25. ════════════════────────────────────────────────────────────────────────────
  26. You may choose a number of different ways to use LOGIT, making it a flexible
  27. tool to show your users your recent system activity.
  28.  
  29. Each of the five functions are run using a command named to describe the
  30. function. Here is a brief description of the functions.
  31.  
  32.     PARAMS    Uses command line to produce output file.
  33.     DOOR.SYS  Reads DOOR.SYS to produce output file.
  34.     COMMENT   Writes text to output file.
  35.     MAILCALL  Adds Last mail session to output file.
  36.     BANNER    Creates Today/Yesterday mailer stats banner file.
  37.  
  38.  
  39. Command Line Usage:
  40. ═══════════════════─────────────────────────────────────────────────────────
  41.     CD\LOGIT
  42.     LOGIT <commands> [parameters]
  43.  
  44. Commands:
  45.  
  46.     PARAMS    [parameters] Uses command line to produce output file.
  47.     DOOR.SYS  Reads DOOR.SYS to produce output file.
  48.     COMMENT   [comment text] Writes text to output file.
  49.     MAILCALL  Adds Last mail session to output file.
  50.     BANNER    Creates Today/Yesterday mailer stats banner file.
  51.  
  52.      
  53. Explained:
  54.    LOGIT PARAMS %1 %2 %3 %4 %5 %6 %7 %8 %9
  55.      ■ Reads command line parameters to produce output file.
  56.  
  57.      ■ %1  Locked Baud Rate   ■ %6  ANSI 1=Y,0=N
  58.      ■ %2  Time Left          ■ %7  Com Port
  59.      ■ %3  User Number        ■ %8  User Baud Rate
  60.      ■ %4  User First Name    ■ %9  Node Number
  61.      ■ %5  User Last Name
  62.  
  63.      ■ Reads Information From DOOR.SYS if it exists.
  64.  
  65.    This is the best way to run this under TAG! 
  66.    TAG's LOGON.BAT drops all these params and DOOR.SYS.
  67.  
  68.  
  69.    LOGIT DOOR.SYS
  70.      ■ Reads Information From DOOR.SYS to produce output file.
  71.  
  72.  
  73.    LOGIT COMMENT [text]
  74.      ■ Writes [text] to output file.
  75.  
  76.    This is nice for telling users when system events happen.
  77.    For example, put it in your nightly maint. batch file like this:
  78.  
  79.      LOGIT COMMENT Ran Nightly Maintenance.
  80.  
  81.  
  82.    LOGIT MAILCALL
  83.      ■ Reads LASTCALL.[FD or IM] and adds the most recent mailer
  84.        call (inbound or outbound) to output file.
  85.  
  86.    This is nice for telling users when your system gets mail.
  87.    Use this with the comment function in your tossmail.bat like
  88.    this:
  89.  
  90.     @ECHO OFF
  91.     @REM Program : TOSSMAIL.BAT
  92.     @REM Usage   : Runs after mailcall to process inbound mail.
  93.  
  94.       CD\FD\LOGIT
  95.         LOGIT MAILCALL
  96.           @REM Reads LASTCALL.[FD or IM] and adds the most recent mailer
  97.           @REM call (inbound or outbound) to output file.
  98.      
  99.       CD\FD\FILE
  100.         IF NOT EXIST C:\FD\FILE\*.* GOTO MAILSCAN
  101.           @REM Looks for any file in the inbound directory.
  102.         IF NOT EXIST C:\FD\FILE\313B*.* GOTO MAILSCAN
  103.           @REM Looks for any Interplanetary BRE mail packet file in the
  104.           @REM inbound directory.
  105.  
  106.       CD\FD\LOGIT
  107.         LOGIT COMMENT  └─ Received & Processed IP-BRE #313 Mail Packet.
  108.           @REM Adds the comment listed after the command "COMMENT" to
  109.           @REM the output file.
  110.  
  111.       CD\BBS\GAMES\IPBRE313
  112.         BRE PLANETARY /DETAILED
  113.         BRSCORES
  114.  
  115.     :MAILSCAN
  116.       IF NOT EXIST C:\FD\FILE\*.* GOTO END
  117.       CD\FD\GECHO
  118.         GECHO SCAN TOSS -TOSSBAD
  119.  
  120.       CD\FD\ALLFIX
  121.         ALLFIX F A
  122.  
  123.     :END
  124.     @REM End Program: TOSSMAIL.BAT
  125.  
  126.  
  127.    LOGIT BANNER
  128.      ■ Reads LASTCALL.[FD or IM].  Creates ASCII output file that
  129.        contains Today / Yesterday mailer stats.
  130.  
  131.      Use this for your mailer's Banner file that is displayed to
  132.      BBS callers before loading the BBS software.
  133.  
  134.  
  135.    LOGIT [commands] DETAILED
  136.      ■ Displays function-by-function details of what LOGIT is doing.
  137.        This is an optional parameter.
  138.  
  139.  
  140. Configuration File:
  141. ═══════════════════─────────────────────────────────────────────────────────
  142. Try running LOGITCFG for starters. Although you can edit your config file
  143. manually, it is easier and safer to configure Logit with this program. You
  144. will need to edit the config file and add your header and foot strings.
  145.  
  146. You will need a separate config file for each node you run, as the path for
  147. DOOR.SYS will vary from node to node. How I run multiple config files is
  148. like this:
  149.  
  150.     LOGIT1.CFG - Node 1's Config File
  151.     LOGIT2.CFG - Node 2's Config File
  152.  
  153. Then before you run logit, copy the right config file to the filename
  154. LOGIT.CFG. To do this: (for node 1)
  155.  
  156.     COPY LOGIT1.CFG LOGIT.CFG
  157.  
  158.  
  159. LOGITCFG.EXE
  160. ════════════────────────────────────────────────────────────────────────────
  161. LOGITCFG.EXE has a nice feature built into it. If you just run:
  162.  
  163.     LOGITCFG.EXE [no command line parameters]
  164.  
  165. It attempts to load LOGIT.CFG. If you run:
  166.  
  167.     LOGITCFG.EXE [filename]
  168.  
  169. It will load 'filename' as your config file so you can edit each node's
  170. config using the config program.
  171.  
  172.  
  173. The config file, explained...
  174. Line 1  - Where to put the Output file.
  175.           Example: C:\MULTI
  176.  
  177. Line 2  - What to call the Output file
  178.           Example: CALLERS.LOG
  179.  
  180. Line 3  - Remove Calls Daily or by Number? [D/N]
  181.           You can use this program two ways. Daily - will remove calls
  182.           at the end of the day. Numericly - Will remove calls after a
  183.           user defined number of calls.
  184.           Example: D
  185.  
  186. Line 4  - Number of calls to record.
  187.           This is the number of calls you wish to show if you use the
  188.           Numeric feature on Line 3. This line must exist even if you
  189.           choose daily. (it will just be ignored, but leave it in!)
  190.           Example: 20
  191.  
  192. Line 5  - Header 1 - Length: 77 characters
  193.           This is the string to use as the top line of your Output file.
  194.           Example:                     4─═1[  9My BBS! 2Callers Log Screen  1]4═─
  195.  
  196. Line 6  - Header 2 - Length: 77 characters
  197.           This is the string to use as the second line of your Output file.
  198.           Example: 4┌─  ─  ── ───────1─4──1─4─1─2─1──2──────────────────1──2─1─2─1─4──1─4────────────── ──  ─  ─┐
  199.  
  200. Line 7  - Foot - Length: 77 characters
  201.           This is the string to use as the bottom of the your Output file.
  202.           Example: 4└─  ─  ── ───────1─4──1─4─1─2─1──2──────────────────1──2─1─2─1─4──1─4────────────── ──  ─  ─┘
  203.  
  204. Line 8  - Text Color (Text)
  205.           The TAG Color Number for the Caller Info Text.
  206.           Example: 2
  207.  
  208. Line 9  - Text Color (Colon)
  209.           The TAG Color Number for the Colon between the Caller info Text.
  210.           Example: 5
  211.  
  212. Line 10 - Path to DOOR.SYS. If you choose not to use DOOR.SYS. Leave this a
  213.           blank line.
  214.           Example: C:\TAG
  215.  
  216. Line 11 - Bulletin Board System. [TAG, RGPIPE, or RGCARROT]
  217.           This line tells LOGIT which color code symbol to use.
  218.                 TAG      - ""
  219.                 RGPIPE   - "|"
  220.                 RGCARROT - "^"
  221.           Example: TAG
  222.  
  223. Line 12 - Include Local Logons? [YES/NO/Y###]
  224.             Yes  - Will Include ALL Local Logons.
  225.             No   - Will Not Include Local Logons.
  226.             Y### - Will Include Local Logons Up To SL=###.
  227.                    Must define DOOR.SYS Path To Use This Last Option
  228.                    But You Can Still Use The "%1 %2, ETC" Command Line.
  229.           Example: YES
  230.  
  231. Line 13 - Path to LASTON.DAT (TAG ONLY)
  232.           This feature is still in Beta Testing. File Request: "LAST"
  233.           from my system to get the stand alone version of the LASTON.DAT
  234.           Colorizer.
  235.           Example: C:\MULTI
  236.  
  237. Line 14 - Path to Mailer (Front Door/Intermail only for now)
  238.           Example: C:\FD
  239.  
  240. Line 15 - Pause String. If none use 'N' (No quotes)
  241.           Example: 
  242.  
  243. Line 16 - Yesterdays Calls Log Filename
  244.           Example: YESTCALL.MSG
  245.  
  246. Line 17 - Mailer Type (Front Door,InterMail,NONE)
  247.           Example: FRONT DOOR
  248.  
  249. Line 18 - Today/Yesterday Mailer Stats Filename
  250.           Example: BANNER.TXT
  251.  
  252.  
  253. Comments:
  254. ═════════───────────────────────────────────────────────────────────────────
  255. If you have trouble using this program, please let me know! I'm sure there
  256. are still bugs I haven't squashed yet, but with time, I'll have all the bugs
  257. out plus a few more features for your enjoyment! 
  258.  
  259. All Copyrights and Trademarks are properties of their respective owners.
  260.  
  261. This program is Freeware. Buy yourself a burger! <Grin>
  262.  
  263. I can be reached via Netmail at:
  264.  
  265.    1:2410/411 (Fido)
  266.    7:313/200 (FlashNet)
  267.    Timothy.Steffes@MyBBS.ACK.MI.ORG (E-Mail)
  268.  
  269. Stop by the FlashNet Web Site for the latest version of this and my other
  270. programs at: HTTP:/WWW.GATECOM.COM/~JACKFLASH
  271.  
  272. F'Req the latest version of Logit using the magic name "LOGIT".
  273.  
  274.  
  275. Thanks!!!
  276. ═════════───────────────────────────────────────────────────────────────────
  277. My many thanks go out to:
  278.   Leann, my wife.  (Marilyn, My BBS!)
  279.     Thank you for not hassling me about the late night programming!
  280.     "Just one more minute babe. I just have one more line to write..."
  281.  
  282.   Mickenzie, my daughter.
  283.     Daddy's little girl, You are the light of my life!
  284.  
  285.   Ken Winstrand, My Best Friend.  (Jack Flash, Jack's Flashdom!)
  286.     Thanks for showing me T.A.G.! We've really run it through its paces,
  287.     haven't we? To Boldly Use Every PKey Like No SysOp Has Done Before!
  288.  
  289.   Wanda Hall, My Bud!  (Rosie, Rosie's Place)
  290.     Thanks for giving me ideas for my programming and all the great work
  291.     you've done on my board. Now WHEN are you going to change your Pause
  292.     String????
  293.  
  294.   Doug Bulmer, Doog!  (Stormin, The War Zone)
  295.     I can't thank you enough for being patient enough to teach me to
  296.     program. A lesser man may have gone completely insane at the mere
  297.     thought. Oh I wish I were an Oscar Mayer wiener!
  298.  
  299.   Randy Goebel, N8MAX.  (Randy, My BBS! Node 3 <wink!>)
  300.     Thank you for letting me redo your board and thanks for the freedom to
  301.     do it the way I want.
  302.  
  303.   The T.A.G. Team,
  304.     Thanks for a kick butt BBS program! Keep up the great work, we all
  305.     greatly appreciate the time, thought and effort that goes into writing
  306.     the best BBS package you can get!
  307.  
  308.   My BBS! Software Beta Sites
  309.     Thanks for having enough faith in my programming that you actually run
  310.     my software (scary!! just kidding!)! Thanks for the GREAT input you
  311.     have given me. I can't thank you enough and I hope to help you improve
  312.     your already excellent BBSs even more with better software that you
  313.     helped create!
  314.  
  315.  
  316. My BBS! Software Test Sites                           FidoNet      FlashNet
  317. ═══════════════════════════───────────────────────────═══════─────════════──
  318. My BBS!               (B) Tim Steffes    313 595-9785  1:2410/411  7:313/200
  319. The War Zone          (B) Doug Bulmer    313 467-9550  1:2410/805  7:313/105
  320. Jack's Flashdom!      (T) Ken Winstrand  313 561-9874  1:2410/710  7:313/100
  321. Rosie's Place         (T) Wanda Hall     313 941-0865  1:2410/520  7:313/104
  322. The Black Hole        (A) Randy Goebel   810 879-7387  1:120/36    7:313/36
  323. K-1 Computing         (I) David Strang   313 359-9261  ----------  7:313/112
  324. College Board         (W) Jim Kennedy    810 478-9647  1:2410/146  7:313/210
  325. Back Of The Garage    (T) Jeffrey Bell   313 565-7756  1:2410/532  7:313/109
  326. Serpent's Twist BBS!  (B) Steve Dimoff   919 848-2347  1:151/184   7:919/100
  327. Diamonds in the Rough (T) Tom Brown      502 439-7904  1:3621/4    7:502/100
  328. Briter                (B) Brian Large    519 974-6829  1:246/29    ---------
  329. The Underworld        (B) Bruce Byrom    606 263-8108  1:2370/100  ---------
  330. The Manhatten Project (G) Brian Cox      313 281-7401  1:2410/701  7:313/102
  331. ────────────────────────────────────────────────────────────────────────────
  332. (T) T.A.G.            (A) T.A.G. Alpha       (W) WildCat      (G) Telegard
  333. (B) T.A.G. Beta       (I) Iniquity           (R) Renegade
  334. ────────────────────────────────────────────────────────────────────────────
  335.  
  336. If you are interested in becoming a Beta Test Site for My BBS! Software,
  337. please fill out BETA.TXT and crash mail it to my system. I will reply within
  338. 48 hours to every message. If you don't hear from me, it means I'm either
  339. dead or lightning struck my PC (which would be worse? <grin>).
  340.  
  341. Thanks, Tim  8^)
  342.